home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / asm / demos / exsyslib / doc / exsyslib.doc < prev   
Encoding:
Text File  |  1980-01-04  |  6.5 KB  |  163 lines
  1.  
  2. ______________________________________________________________________________
  3.  
  4.                                     /
  5.                                                                      /
  6. \                               /\/                               /\/
  7.                                /                                     
  8.    \              _________ ____ ____ ____ ____     /\      /
  9.           .---\_  __  /|    ¡    |    ¡    |----.      /
  10.           |:::|      / |    |    |    |    |::::|  \  /
  11.           |:::|     ___|__  |  __|    |    |__.:|   \/
  12.           |:::|    |   |         |            |:|
  13.           |:::|    ¡   |    ¡    |----.    .--':|
  14.          /|:::|        |    |    |    |    |::::|
  15.         / `---^--------^----^----'    `----^----'
  16.     \  /                                              \                /
  17.      \/       /   »»»»»-[ pRoUDLY pReSeNTS ]-««««««         /\        /
  18.              /                                          \  /  \      /
  19.         /\  /                                            \/    \    / 
  20.        /  \/                                                    \  /
  21.       /                 The *NEW* 'exsys.library'...             \/
  22.  
  23.     /  A Brand new library to make life easier (and more compatible!)
  24.                  for all productive demo & game coders !!!
  25.  
  26.  
  27.  
  28.                         An EX4-Production for `95!
  29.  
  30. ______________________________________________________________________________
  31.  
  32.  
  33.  
  34.  
  35.         What is this 'exsys.library' all about ?
  36.     -----------------------------------------------------
  37.  
  38.  
  39. Welcome, you`ve just got yourself a copy of the new library thats improving
  40. compatibilty of demos and games throughout the Amiga scene. This library is
  41. a new concept for demos and games that 'hit the hardware'. Basically it
  42. provides all the 'OS Freezing' and 'OS Restoring' routines. Usually these
  43. are where most demos and games will fail on newer amigas (or sometime even
  44. faster accelerated ones!) Yes no longer do you need to write your own 
  45. 'KillOS' or 'RestoreOS' functions in the worry that one day you`ll find an 
  46. amiga that your demo crashes on because of a faulty startup code...
  47.  
  48. All you need to do is add 'ONE' line to your source-codes !!! Yes that right
  49. we`ve made it so simple to use that its perfect for all, beginners and the
  50. more experienced too. Its also great for tutorial writers...
  51.  
  52.         include    'ex_takesys.s'    ;*1st code line in your demo/game *
  53.  
  54. This will add about 16 lines of assembly object code to the start of your
  55. demo/game. All that is does is to open the 'exsys.library' and call the
  56. appropriate os killing/restoring functions. The startup code is TINY, taking
  57. only about 80 bytes of code.. Far less than writing your own startup code
  58. would be.. and the library itself is small occupying about 1k of diskspace.
  59.  
  60. All you need to do for your demos/games to work is copy the 'exsys.library'
  61. (supplied in the archive) to your libs: directory. When creating a new 
  62. bootable disk simply make a directory called 'libs' and copy the 1k library
  63. into this draw.. Thats it! fully working.. Now if for some reason a new
  64. Amiga or Operating system / cpu accelerator ,etc comes out that renders the
  65. old 'exsys.library' startup code bad then all that will be required for
  66. your demos/games to work is new version of the 'exsys.library'. If you had
  67. written your own startup code you`d have to completely re-write your startup
  68. code and re-assemble the demo/game...
  69.  
  70. Ie; your demo`s/game`s will always work correctly without them having to be
  71. re-written!!!! Pop in a new updated library and your away!!!!!!!!!!
  72.  
  73. If you take the time to experiment with this rather useful library you will
  74. reap the rewards later when the more advanced versions become available with
  75. all manner of useful features. Also crash proofing will be transparently
  76. added to the kill OS functions therfore making your demos/games safer too!!
  77.  
  78.  
  79.  
  80.  
  81.  
  82.                        Advantages of the new library
  83.                  ----------------------------------------
  84.  
  85.  
  86.     » Makes coding demos/games easier and less tedious..
  87.       Simply add 1 line to your source-codes and your away!!
  88.  
  89.     » No longer do you need to worry about the operating system
  90.       getting in the way or making you demos incompatible with
  91.       future releases of OS`s...
  92.  
  93.     » Fully compatible with OCS/ECS and AGA.
  94.       No copperlist tricks, extra`s, etc, needed for AGA, etc.
  95.  
  96.     » Improves future compatiblity of your demos
  97.       and games...
  98.  
  99.     » Library occupies a tiny 1k of space on disk
  100.       and is fully freeware distributable...
  101.  
  102.     » New versions will be released as and when needed to maintain
  103.       future compatiblity...
  104.  
  105.     » Newer versions planned for release very soon will have 
  106.       crash proofing implemented. Meaning that a division by zero
  107.       or other exception errors will not crash your demo/game. Instead
  108.       a nice message will be reported and then restore itself safely..
  109.  
  110.     » We may even release a debugging version of the library that
  111.       has a built in debugger/dissassembler/tracer & mempeeker! This
  112.       is ofcourse if we see the library in widespread use and therefore
  113.       think its worth it spending the time to do this!!! 
  114.  
  115.  
  116.  
  117.  
  118.                     Disadvantages of the new library..
  119.               ----------------------------------------------
  120.  
  121.     The only disadvantage is that you`ll need to supply it with your 
  122. demos/games. However the library can be freely distributed and really
  123. having to include it is NOT really a disadvantage since it only occupies a 
  124. mere 1k of diskspace but has many benefits.. Decide for yourself..
  125.  
  126.  
  127.  
  128.                    How to use the Library from Assembly
  129.         --------------------------------------------
  130.  
  131.       Its simpliciy itself, please refer to the example source-codes 
  132.                     (they are supplied in the archive)
  133.  
  134.  
  135.  
  136.  
  137.                                Final Notes..
  138.                           -----------------------
  139.  
  140.  
  141.     The EX4-Codersdisks will be supporting the new 'exsys.library' in
  142. the demos/games source-codes supplied. This will make readability of the
  143. source easier and also maintain compatiblity for the future...
  144.  
  145.  
  146.                    If future compatibility worries you,
  147.          The exsys.library keeps your future compatibility bright!
  148.  
  149.  
  150.  
  151.                              Copyright Notice
  152.                     ----------------------------------
  153.  
  154.                   Idea concieved by 2-Cool & The Art/EX4.
  155.                   Design & Implementation By 2-Cool/EX4.
  156.  
  157.              Copyright EX4 (c) 1995. All Rights Are Reserved.
  158.  
  159.       The library itself may be freely distributed. However the idea
  160.   and its contents remain copyright to EX4 and its respective author(s).
  161.  
  162. ______________________________________________________________________________
  163.